package com.qianying.service;

import com.qianying.comment.CommonResult;
import com.qianying.entity.CustomerContact;

import java.util.List;

/**
 * 客户主要联系人业务逻辑接口
 * @author check
 * @date 2023-10-20
 */
public interface CustomerContactService {
    /**
     * 根据ID查询联系人
     * @param id 联系人ID
     * @return 联系人信息
     */
    CommonResult<CustomerContact> getById(Long id);

    /**
     * 添加联系人（自动忽略ID）
     * @param entity 联系人实体
     * @return 添加结果（包含新生成的ID）
     */
    CommonResult<CustomerContact> save(CustomerContact entity);

    /**
     * 更新联系人（必须包含ID）
     * @param entity 联系人实体
     * @return 更新结果
     */
    CommonResult<?> updateById(CustomerContact entity);

    /**
     * 删除联系人（必须指定ID）
     * @param id 联系人ID
     * @return 删除结果
     */
    CommonResult<?> removeById(Long id);

    /**
     * 根据客户ID查询所有联系人
     * @param customerId 客户ID
     * @return 联系人列表
     */
    CommonResult<List<CustomerContact>> getByCustomerId(Long customerId);
}